{\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf360
{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fmodern\fcharset0 Courier;\f2\fmodern\fcharset0 Courier-BoldOblique;
}
{\colortbl;\red255\green255\blue255;}
\margl1440\margr1440\vieww15720\viewh10780\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\f0\b\fs28 \cf0 Instructions for getting the CalGames scoresheet development files
\fs24 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b0 \cf0 We are using Subversion (SVN) to manage the files as we develop the CalGames scoring spreadsheet.\
\
Because several people who may want to follow the development may not want to learn how to use Subversion, we will also try to place files in the download area of the project, where SVN is not needed.\
\
\
Before continuing, let me say that I am happy to provide telephone help in getting started with SVN.  If you are having trouble or just want me to walk you through the process, give me a call!  I am providing brief instructions here, but I can provide more complete verbal instructions.\
-David\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b\fs32 \cf0 Quick Start
\b0\fs24 \
The project is located at:\

\b   http://code.google.com/p/calgames/\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b0 \cf0 The SVN instructions are in the 
\i Source
\i0  tab\
\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b \cf0 Access to the CalGames scoring project\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b0 \cf0 Contact me or another owner of the project to add you to the members.\
\ul You need a gmail account \ulnone to contribute directly to the project, since it is hosted by GoogleCode.\
If you don't have a gmail account, you can still access all the files in the SVN repository, but to add/modify a file, you will have to e-mail the files to a project member, such as myself, who can commit (add) the file on your behalf.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b\fs32 \cf0 SVN / TortoiseSVN installation
\b0\fs24 \

\b Windows computers
\b0 \
I highly recommend using the graphical user interface "TortoiseSVN".  It is easier to learning SVN and managing the files of an SVN project is easier using TortoiseSVN.  TortoiseSVN is available for free from http://tortoisesvn.net/  .  TortoiseSVN modifies your menus on Windows Explorer.  TortoiseSVN does not install any advertisements.    It is widely used in the software development community.\
\

\b Mac, Linux,
\b0  and command line users\
The SVN application SVN is controlled via the command line. \
  On the Mac, SVN is already installed (I believe).  Use the mac's Terminal application. You should get a response if you type "svn --version".  If that command doesn't work, let me know.  I'll have to give a bit more help in locating SVN for you.\
Linux -- you are on your own!\
\
\

\b\fs32 Using SVN
\b0\fs24 \
The key commands in SVN are:\
  
\b checkout
\b0   (get a new copy)\
  
\b update
\b0  (update the files)\
  
\b commit
\b0  (add modified & new files back onto the repository)\
  
\b add
\b0  (mark files and directories to be added on the next "commit" to the repository)\
  
\b status
\b0  (list what is going to happen when you "commit")\
\
Caution: Do not use TortoiseSVN's "create" in our project.  This will create a new repository (archive) on your computer which is not what you want.  You want a "working copy" of the files.\
\
\

\b TortoiseSVN 
\b0 (Windows only)\
The online Manual: \
  http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html\
\
Read Chapter 1\
Read the sections:\
  4.7 The Checkout dialog\
  4.8 The Commit dialog\
\
\
\
The project URL is:\
  
\f1 https://calgames.googlecode.com/svn/trunk/\
\
or, for read-only (non-members), change https to http:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\f0 \cf0   
\f1 http://calgames.googlecode.com/svn/trunk/\

\f0 \
\
From Windows eIn the checkout dialog, \
    http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html#tsvn-dug-checkout-dia-1\
Enter the location of the repository that can be found in the "Source" tab of the googlecode project\
   
\f1 https://calgames.googlecode.com/svn/trunk/\

\f0 \
To commit, project members need their password which is available at:\
  http://code.google.com/p/calgames/source/checkout\
\
\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b \cf0 Command line SVN - Mac, Linux, etc.:\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b0 \cf0 The online Manual:   http://svnbook.red-bean.com/  or google "Red svn"\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\i\b0 \cf0 These comands should be entered from the terminal (Mac) or command-line (Linux, etc).
\i0 \
\
First, visit: \
  http://code.google.com/p/calgames/source/checkout\
\
\ul Project Members:\ulnone \
Navigate on your computer to the folder that you want the working copy.  Then, from a command line (terminal on mac) type:\
\pard\pardeftab720\ql\qnatural

\f1 \cf0 svn checkout 
\f2\i\b https
\f1\i0\b0 ://calgames.googlecode.com/svn/trunk/ calgames_svn --username yourGmailAccount@gmail.com
\f0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\cf0 \
or\
\ul Non-Members:\ulnone \
  
\f1 svn checkout 
\f2\i\b http
\f1\i0\b0 ://calgames.googlecode.com/svn/trunk/ calgames-read-only
\f0 \
\
When returning to work on the files in your project's working copy, you should "update" and get any recent changes anyone made:\
  
\f1 svn update
\f0 \
\
\
To save your work of an existing file, you "commit" the files and add a message:\
  
\f1 svn commit -m "added red/blue to the document;  -your name"
\f0 \
\
You will need your googlecode project password, available at:\
  http://code.google.com/p/calgames/source/checkout\
\
To add a file, or directory, use the "add" command\

\f1  svn add  2012/myNewFile
\f0 \
The parent directory  must already be added to the project.\
\
\
\
\
\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\b \cf0 Additional help using SVN and TortoiseSVN may be found here:
\b0 \
  Google "Red SVN" for the official free documentation\
	http://svnbook.red-bean.com/\
  Look for Help within the TortoiseSVN graphical interface\
	http://tortoisesvn.net/support.html\
\

\b Closing Comments
\b0 \
Hope this is enough to get you started.  Again, I am happy to provide more assistance than I can provide here.\
Subversion / SVN is a great tool for teams to manage their software, financial documents, and their CAD files.  I think it well worth the effort to learn -- it's allowed many more students to contribute on our team.\
\
 -David Giandomenico}